// 路由钩子官方叫做路由守卫
// 具体有哪些钩子和用法参考官方文档https://router.vuejs.org/zh/guide/advanced/navigation-guards.html

// 常用到的是全局路由前置钩子
// 主要用来在路由跳转前做一些事情，比如判断用户是否登陆
router.beforeEach((to, from, next) => {
  if (to.name !== 'Login' && !isAuthenticated) next({ name: 'Login' })
  else next()
})

//钩子函数中的router是已经被实例化的router对象。所以一般放在Vue实例化之前。
// 比如放到入口文件或router配置文件中

const router = new VueRouter({ ... })

router.beforeEach((to, from, next) => {
  // ...
})


/* 
 每个守卫方法接收三个参数：
 
 to: Route: 即将要进入的目标 路由对象
 
 from: Route: 当前导航正要离开的路由
 
 next: Function: 一定要调用（若不执行next(),路由将不会跳转）该方法来 resolve 这个钩子。执行效果依赖 next 方法的调用参数。
 
 next(): 进行管道中的下一个钩子。如果全部钩子执行完了，则导航的状态就是 confirmed (确认的)。next为回调函数，执行next路由才会进行跳转。
 
 注意：确保 next 函数在任何给定的导航守卫中都被严格调用一次，若多次执行，路由跳转会发生未知的严重错误
 
 next(false): 中断当前的导航。如果浏览器的 URL 改变了 (可能是用户手动或者浏览器后退按钮)，那么 URL 地址会重置到 from 路由对应的地址。
 
 next('/') 或者 next({ path: '/' }): 跳转到一个不同的地址。当前的导航被中断，然后进行一个新的导航。你可以向 next 传递任意位置对象，且允许设置诸如 replace: true、name: 'home' 之类的选项以及任何用在 router-link 的 to prop 或 router.push 中的选项。
 
 next(error): (2.4.0+) 如果传入 next 的参数是一个 Error 实例，则导航会被终止且该错误会被传递给 router.onError() 注册过的回调。
 */